home *** CD-ROM | disk | FTP | other *** search
/ Aminet 50 / Aminet 50 (2002)(GTI - Schatztruhe)[!][Aug 2002].iso / Aminet / util / wb / DopusOnlineRx.readme < prev    next >
Text File  |  2002-06-02  |  4KB  |  101 lines
  1. Short:    Dopus5 Appicons for Amisat and Charon
  2. Author:   Steve@hargreavess.freeserve.co.uk (Steve Hargreaves)
  3. Uploader: Steve@hargreavess.freeserve.co.uk (Steve Hargreaves)
  4. Version:  1.0
  5. Type:     util/wb
  6. Requires: rexxsupport.library, rexxmast, Dopus5, Charon and/or Amisat
  7.  
  8. What is this? Quite simply, it's a pair of scripts that will
  9. place appicons on your dopus desktop for Amisat and Charon. Each
  10. icon can be used to launch/quit the respective programs, and the
  11. icon imagery will change according to the status of the
  12. application (running/not running). In the case of Charon, if
  13. Charon is running, the icon can also be used to open the GUI.
  14.  
  15. Why? Well, Amisat on teh Amiga has no GUI at all, so I thought it
  16. would be useful to have some way of telling if the program was
  17. running, and to control it. For Charon, I load this on an "On
  18. Demand" basis, and wanted to be able to tell if it's currently
  19. downloading, and to start/stop it at will without having to use
  20. the full GUI. The Charon script will respect resumed downloads.
  21.  
  22. Installation:- AmisatAppIcon.dopus5
  23.  
  24. This is the easiest of the two. Simply copy the script to
  25. Dopus5:arexx and the icons (saton.info and satoff.info) to
  26. Dopus5:Images. In your online script, include a line "Run RX
  27. Dopus5:arexx/AmisatAppIcon.dopus5" (without the double quotes)
  28. will do it. If you don't use run, then your online script will
  29. halt, since the Amisat script doesn't return until you quit it.
  30.  
  31. CharonAppIcon:-
  32.  
  33. Start installation as for AmisatAppIcon. Additionally, copy the
  34. script charonchange.rexx to Rexx: You will need to edit
  35. charonpath in the CharonAppIcon.dopus5 script to suit your set up
  36. (use a standard text editor).
  37.  
  38. Now configure Charon as follows:-
  39.  
  40. Global1:-
  41.  
  42. On start execute Run >NIL:RX rexx:charonchange.rexx on
  43. On exit execute rx rexx:charonchange.rexx off
  44.  
  45. Global2:-
  46.  
  47. Check Auto exit
  48.  
  49. That's it - installation is complete, and whenever you go online,
  50. Charon and Amisat will be started automatically and the appicons
  51. displayed.
  52.  
  53. Usage.
  54.  
  55. Double click to toggle the status of the respective programs (If
  56. it's running, it will quit and vice versa).
  57.  
  58. Icon popup menus:-
  59.  
  60. "Information" will open a window showing the
  61. current status. In the case of Charon, if it's running, this
  62. option will open the GUI.
  63.  
  64. "Close" will quit the associated program and close the appicon.
  65.  
  66. Quitting the scripts:-
  67.  
  68. OK - DON'T send a break to either - the script will not cleanup
  69. after itself if you do, and you'll be left with a stray appicon
  70. on your desktop. Either use close from the popup menu, or, as I
  71. do, use the enclosed ofl.rexx script. Simply copy the script to
  72. Rexx: and include in your offline script "RX ofl.rexx" (Without
  73. the double quotes)
  74.  
  75. Note:- the ofl.rexx script will also quit RC-FTPD if you use it.
  76. I left it in because some may find it useful. If you don't use
  77. RC-FTPD, then don't worry, it won't hurt anything.
  78.  
  79. Known bugs:-
  80.  
  81. Well, just the one, actually. If you use AmDynDns these scripts
  82. will probably fail. This is because AmDynDns is actually a
  83. compiled Arexx script, which disposes of rexxsupport.library on
  84. exit. Since these two scripts make a lot of use of
  85. rexxsupport.library, then they would fail with an error (leaving
  86. the icon on your desktop) at some point.
  87.  
  88. Use the alternative AmiDynDns which doesn't suffer from this
  89. problem.
  90.  
  91. Other Info:-
  92.  
  93. For both scripts, the supplied icons are examples. You can use
  94. your own by overwriting Dopus5:images/saton.info satoff.info
  95. charon.info and charoff.info with your own icons.
  96.  
  97. Author:-
  98.  
  99. Bug reports, compliments, gratuities etc. can all be sent to me
  100. at Steve@hargreavess.freeserve.co.uk
  101.